home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / utils / x10dc165.zip / X10DCDOS.EXE / X10DC.DOC < prev    next >
Text File  |  1996-06-09  |  55KB  |  1,137 lines
  1. --------------------------------------------------------------------
  2. X10DC X-10 Direct Control
  3. --------------------------------------------------------------------
  4. Version 1.65
  5. June 1996
  6.  
  7. Copyright 1993-1996 - D.Huras - All Rights Reserved
  8.  
  9. -----------------------------------------------X10DC.DOC v1.65------
  10. CONTENTS
  11. --------------------------------------------------------------------
  12.  1. DESCRIPTION                13. UNDOCUMENTED CP290 COMMANDS
  13.  2. WARRANTY                   14. INCREMENTAL BRIGHTENING
  14.  3. FEATURE OVERVIEW           15. CP290 SELF TEST
  15.  4. REQUIREMENTS               16. SIGNAL TEST GENERATOR
  16.  5. INSTALLATION INSTRUCTIONS  17. CP290 TRANSMISSION LOGGING
  17.  6. COMMAND LINE ARGUMENTS     18. CLOCK SYNCHRONIZATION
  18.  7. COMMUNICATION PORTS        19. BASE HOUSECODE
  19.  8. OPERATING MODES            20. PROBLEM RESOLUTION
  20.  9. DEBUG MODE                 21. REGISTRATION INFORMATION
  21. 10. PROGRAM OVERVIEW           22. UPGRADE INFORMATION
  22. 11. KEYBOARD USAGE             23. RELEASE HISTORY
  23. 12. MENU BAR
  24.  
  25. 1. DESCRIPTION
  26. --------------------------------------------------------------------
  27. X10DC is a program which sends immediate commands to the X-10 CP290
  28. (*1) Computer Interface.  The CP290 transmits these commands over the
  29. power line to control X10 devices.  X10DC does not currently modify
  30. the EVENT DATA stored in the CP290 Interface (*2).  X10DC is a DOS
  31. program that uses a simple point & click user interface.  (A Mouse
  32. though not required is highly recommended).  X10DC is designed to be
  33. robust software that is processor speed independent.  This program is
  34. shareware and you are invited to evaluate it for 30 days. If you
  35. continue to use the program after the 30 day evaluation period you are
  36. asked to register it.  The author retains all rights to the program.
  37.  
  38. (*1) The CP290 Computer Interface is a device manufactured by X-10
  39.      that can be connected to a micro-computer serial port.  The CP290
  40.      also plugs into an electrical outlet and it is through this
  41.      connection that the CP290 imposes X-10 commands onto the powerline.
  42.      X-10 commands use the power line as a carrier; other X-10 devices
  43.      connected to the power line will respond to these commands (ie.
  44.      switch ON/OFF lights, appliances).
  45.  
  46. 2. WARRANTY
  47. --------------------------------------------------------------------
  48. X10DC is supplied as is.  The author disclaims all warranties,
  49. expressed or implied, including, without limitation, the warranties
  50. of merchantability and of fitness for any purpose.  The author
  51. assumes no liability for damages, direct or consequential, which may
  52. result from the use of X10DC.
  53.  
  54. 3. FEATURE OVERVIEW
  55. --------------------------------------------------------------------
  56. - User-Friendly point & click DOS character-based Interface
  57.  
  58. - All program functions can be controlled using a mouse; no keyboard
  59.   intervention is required.
  60.  
  61. - Supports Standard CommPorts 1 thru 4 and a User Defined CommPort
  62.   which can support any IRQ between 1 & 15 (inclusive) and any
  63.   Base I/O Address.
  64.  
  65. - SUPPORTS * 5 * UNDOCUMENTED CP290 Commands
  66.  
  67. - The Program supports 3 operating modes; each mode uses a different
  68.   combination of on-screen controls.  Mode 1 is suggested for users
  69.   not using a mouse.
  70.  
  71. - When running in Mode 3, the program reads in an X10.DAT file
  72.   [this file format is used by the X10 Program supplied with
  73.   the CP290 Interface] and presents a list box of device
  74.   descriptions/locations which can be targetted for commands.
  75.   (The Unregistered version will only send commands to the 1st
  76.    8 Devices found; SEE REGISTRATION BENEFITS)
  77.  
  78. - Commands can be sent to all 256 X10 device addresses.
  79.  
  80. - Commands can be targetted for any number of units within an X10
  81.   House Code
  82.  
  83. - Supports 16 discrete dimming levels.
  84.  
  85. - Comprehensive CP290 Diagnostic Features
  86.   - A software-based Signal Test Generator is available to assist in
  87.     identifying and isolating X10 transmission/reception problems.
  88.  
  89.   - A CP290 Self Test with event preservation is supported.
  90.     (*2) NOTE, the self test overwrites the EVENT/ICON DATA.  X10DC
  91.     will preserve the EVENT/ICON DATA by downloading it from the
  92.     CP290, saving it in memory, running the Self Test, and
  93.     finally uploading the saved EVENT/ICON DATA back to the CP290.
  94.  
  95.   - CP290 Transmission Logging; captures the CP290 'command echoes'
  96.     that accompany each X-10 command the CP290 transmits.  Includes
  97.     Transmission Log Print Facility.
  98.  
  99.   - Acknowledgements sent from the CP290 (after receiving commands
  100.     from the program) are monitored and checksums are verifed.
  101.  
  102.   - A Debug Mode is available which reports all data sent from the
  103.     CP290 as well as timing information.
  104.  
  105. - A scrollable Command History is available for browsing while the
  106.   program is running.
  107.  
  108. - Clock Synchronization function for the CP290 and the PC
  109.  
  110. - Change Base HouseCode stored in the CP290 function with
  111.   or without Event & Icon Data Preservation.
  112.  
  113. - Detects and exploits EGA/VGA 43/50 line mode
  114.  
  115. - A comprehensive on-line Help sub-system that can be disabled
  116.   at the user's option to decrease program load time.
  117.  
  118. - The program WILL load without a CP290 Interface attached, however
  119.   all attempts at serial communications will result in errors; the
  120.   program will attempt to trap all such errors.
  121.  
  122. 4. REQUIREMENTS
  123. --------------------------------------------------------------------
  124. - An IBM-Compatible PC with at least 1 serial port.
  125.  
  126. - An X10 CP290 Computer Interface attached to a serial port.
  127.  
  128. - A Microsoft-Compatible Mouse is highly recommended
  129.  
  130. - A Colour adapter/display is recommended although the program
  131.   should run with a monochrome display/adapter.  If you
  132.   experience problems with the default colors, then try the /BW
  133.   command line argument which will set everything to Black &
  134.   White.
  135.  
  136. The program requires approximately 450K available conventional memory
  137. to run.  The Command History will consume up to an additional 32K
  138. of memory however this translates to approximately 1000 commands; its
  139. unlikely that this many commands will be sent during one invokation of
  140. the program.  However, if Debug Mode is on, the Command History will
  141. quickly fill up since all CP290 responses are reported in the
  142. Command History list box.
  143.  
  144. 6. INSTALLATION INSTRUCTIONS
  145. --------------------------------------------------------------------
  146. There are no special installation instructions; simply run the
  147. SETUPDOS program will will extract files from the X10DCDOS.EXE file.
  148. X10DC will look for 3 files in the directory it is run from.  However,
  149. the program will run with or without the following 3 files:
  150.  
  151.   1) X10.DAT
  152.      If you want to use Mode 3 then you may want to copy an
  153.      X10.DAT file to the sub-directory where you have installed
  154.      X10DC.EXE.  Alternatively, you can load an X10.DAT file from
  155.      any sub-directory by using the 'Load X10 File' menu option.
  156.      An X10.DAT file is a file format used by the X10 program
  157.      supplied by X10 with the CP290 interface.  The unit
  158.      addresses, locations and descriptions are read from this
  159.      file and presented in a list box by X10DC.  X10DC DOES NOT
  160.      MODIFY THE X10.DAT FILE.  A sample X10.DAT is provided
  161.      with X10DC.
  162.  
  163.   2) X10DC.HLP
  164.      X10DC retrieves the on-line help text from this file. If the
  165.      file is not found then X10DC will display a message during
  166.      startup and then continue.  The help feature will be
  167.      unavailable in this case.  If you decide that you no longer
  168.      need the help sub-system, then you should run the program
  169.      with the /NH command line argument; this will suppress the
  170.      'Help not found' message and decrease program load time.
  171.  
  172.   3) X10DC.INI
  173.      The program will look for a X10DC.INI file in the current
  174.      directory.  The X10DC.INI file is a text file containing all
  175.      program parameters; there is no need to create this file
  176.      yourself since the program will generate one whenever you
  177.      select the 'Save Options' menu item.  A sample X10DC.INI file
  178.      (generated by X10DC.EXE) is shown below:
  179.  
  180. ;
  181. ;X10DC.INI File Created: 10-04-1994 06:30:22
  182. ;All Lines prefixed with ; are ignored
  183. ; ---------------------------------------------------------
  184. ;
  185. ; CommPort=1,2,3 OR 4  DEFAULT=1
  186. ;
  187. [Communications]
  188. CommPort=2
  189. ;
  190. ; Startup Options
  191. ; ---------------
  192. ; Mode=1,2 OR 3                  DEFAULT=1
  193. ; Debug=ON/OFF                   DEFAULT=OFF
  194. ; X10File=[d:]\FILENAME.EXT      DEFAULT=X10.DAT
  195. ; LoadHelp=YES/NO                DEFAULT=YES
  196. ; Sounds=ON/OFF                  DEFAULT=ON
  197. ; PreserveICONData=YES/NO        DEFAULT=NO
  198. ; RefreshClocks=0 TO 9           DEFAULT=9
  199. ;
  200. [Startup]
  201. Mode=3
  202. Debug=OFF
  203. X10File=F:\X10\XA\X10.DAT
  204. LoadHelp=YES
  205. Sounds=ON
  206. PreserveICONData=YES
  207. RefreshClocks=0
  208. ;
  209. [Display]
  210. ThreeD=YES
  211. Shadow=YES
  212. Graphics=YES
  213. ;
  214. ; Colour Values
  215. ; -------------
  216. ; 0=Black  4=Red       8=Gray          12=Bright Red
  217. ; 1=Blue   5=Magenta   9=Bright Blue   13=Pink
  218. ; 2=Green  6=Brown    10=Bright Green  14=Yellow
  219. ; 3=Cyan   7=White    11=Bright Cyan   15=Bright White
  220. ;
  221. BackColor=7
  222. ForeColor=0
  223. HiLiteKey=12
  224. DisabledItem=8
  225. MenuBackColor=1
  226. MenuForeColor=7
  227. MenuSelectedBackColor=0
  228. MenuSelectedForeColor=7
  229. LabelBackColor=15
  230. LabelForeColor=1
  231. Hilite1ForeColor=4
  232. Hilite2ForeColor=1
  233. Hilite3ForeColor=14
  234. HelpTitleBackColor=5
  235. HelpTitleForeColor=15
  236. StatusTitleBackColor=4
  237. StatusTitleForeColor=15
  238. WarningTitleBackColor=12
  239. WarningTitleForeColor=15
  240. ;
  241. ; End of X10DC.INI (06:30:22)
  242.  
  243. This X10DC.FILE was created using the 'Save Options' menu item.
  244.  
  245. NOTE:the DEBUGFORECOLOR directive was replaced with HILITE1FORECOLOR
  246.      effective with Version 1.50.  However, X10DC will still
  247.      recognize DEBUGFORECOLOR and map it to HILITE1FORECOLOR.
  248.      When the INI file is rewritten, the old directive will be
  249.      replaced.
  250.  
  251.  
  252. 6. COMMAND LINE ARGUMENTS
  253. --------------------------------------------------------------------
  254. DEFAULTS:  If the program is run without any command line arguments
  255.            it will default to COMMPORT 1,OPERATING MODE 1,DEBUG OFF,
  256.            F:X10.DAT.
  257.  
  258. The following command line arguments can be entered in any order:
  259.  
  260. /Annnn(n) - Base I/O Address applicable to User Defined CommPort
  261.             (Must be specified as a decimal number)
  262.             If /I agrument is present, but /A is not; then Base
  263.             I/O Address will default to 1016 (3F8 Hex).
  264.  
  265. /BW  - Use Monochrome colours (Black & White)
  266.  
  267. /Cn  - COMMPORT where n = 1,2,3 & 4
  268.        ALWAYS overrides User Defined CommPort during Program Startup
  269.  
  270. /D   - TURNS ON DEBUG MODE
  271.        When DEBUG MODE is ON, the CP290 responses & checksums are
  272.        displayed in the Command History List Box.
  273.  
  274. /F:[d]\filename - X10.DAT FILE SPECIFICATION for MODE 3
  275.       where [d] = drivespec eg. /F:C:\X10\X10.DAT
  276.  
  277. /In  - IRQ applicable to User Defined CommPort where n = 1 - 15
  278.        If /A argument is present, but /I is not; then IRQ
  279.        will default to 4.
  280.  
  281. /Mn  - MODE where n = 1,2 or 3
  282.        MODE 1 Provides a List Box of Unit Codes; only 1 Unit Code
  283.               can be selected.  However, this mode will be easier to
  284.               use if you don't have a mouse since you'd have to TAB
  285.               through all the unit code check boxes used in MODE 2.
  286.        MODE 2 Provides a Check Box for each Unit Code plus ALL and
  287.               NONE buttons to quickly Check/Uncheck all check boxes.
  288.               In this mode, multiple Unit Codes can be targetted for
  289.               the X10 Command.
  290.        MODE 3 Provides a List Box of Devices which are read from
  291.               an X10.DAT file; X10DC will look for "X10.DAT" in the
  292.               current directory UNLESS the /F: command line argument
  293.               is supplied.  If X10.DAT cannot be found, the program
  294.               will switch to Mode 1.  Select 'Load X10 File' under
  295.               the File menu to load an X10.DAT file from another
  296.               sub-directory. (Once the file is loaded, its location
  297.               can be saved [REGISTERED VERSION ONLY] by selecting
  298.               'Save Options' under the Options menu.
  299.  
  300. /NH  - Do Not Load HELP Sub-System
  301.  
  302. /NH- - Load HELP Sub-System (Override INI directive)
  303.  
  304. /NS  - No Sounds during Signal Test
  305.  
  306. /NS- - Sounds during Signal Test (Override INI directive)
  307.  
  308. /P   - Toggles ON 'Preserve ICON Data'
  309.        Normally, X10DC will only preserve the Event Memory stored
  310.        in the CP290.  This is because the DOS-based CP290 software
  311.        only utilizes the CP290 Event Memory and does not utilize the
  312.        CP290 Icon memory area.  However, X10EC does store information
  313.        in the Icon memory, and X10DC has been upgraded to preserve
  314.        the Icon memory area for compatibility reasons.
  315.  
  316.  
  317.              NOTE: ONLY THE 1st 8 DEVICES CAN BE TARGETTED FOR
  318.                    COMMANDS WITH THE UNREGISTERED VERSION.
  319.  
  320.        1) Most Command Line directives (with the exception
  321.           exception of /A,/I & /NH) can be modified once the
  322.           program loads by selecting the appropriate menu items
  323.           under the Options Menu.  Registered Users can save all
  324.           these settings to the X10DC.INI file by using the 'Save
  325.           Options' menu item.
  326.  
  327.        2) COMMAND LINE OPTIONS OVERRIDE ALL X10DC.INI SETTINGS
  328.  
  329. 7. COMMUNICATION PORTS
  330. --------------------------------------------------------------------
  331. X10DC supports "pseudo standard" CommPorts 1 thru 4 using the
  332. following settings:
  333.  
  334.             +----------+------+------------------+
  335.             |          |      | Base I/O Address |
  336.             | CommPort | IRQ  +---------+--------+
  337.             |          |      | Decimal |  HEX.  |
  338.             +----------+------+---------+--------+
  339.             |    1     |   4  |  1016   |  3F8   |
  340.             +----------+------+---------+--------+
  341.             |    2     |   3  |   760   |  2F8   |
  342.             +----------+------+---------+--------+
  343.             |    3     |   4  |  1000   |  3E8   |
  344.             +----------+------+---------+--------+
  345.             |    4     |   3  |   744   |  2E8   |
  346.             +----------+------+---------+--------+
  347.  
  348. If one of these CommPort settings matches your hardware
  349. configuration simply select the appropriate CommPort from the
  350. Communications Options screen.  (You could also start X10DC with the
  351. /C command line argument or use the COMMPORT= X10DC.INI directive).
  352.  
  353. You can define your own CommPort by selecting User Defined CommPort
  354. from the Communications Options screen and setting the IRQ interrupt
  355. and Base I/O Address.  (You could also use the /I and /A Command
  356. Line Args or IRQ= & Base_IO_Address= X10DC.INI file directives).
  357. IRQ can be set to any value between 1 and 15 (inclusive).  Base I/O
  358. Address can be set to any value greater than zero.  CAUTION: your
  359. hardware may "lock up" if incorrect settings are used.  Once you
  360. have enabled communications with the CP290, then use the 'Save
  361. Options' menu item to save the information to the X10DC.INI file.
  362.  
  363. THE BASE I/O ADDRESS MUST BE SPECIFIED IN DECIMAL NOTATION.
  364.  
  365.           IBM PS/2 CommPort Parameters are shown below:
  366.             +----------+------+------------------+
  367.             |   PS/2   |      | Base I/O Address |
  368.             | CommPort | IRQ  +---------+--------+
  369.             |          |      | Decimal |  HEX.  |
  370.             +----------+------+---------+--------+
  371.             |    1     |   4  |  1016   |  3F8   |
  372.             |    2     |   3  |   760   |  2F8   |
  373.             |    3     |   3  | 12832   | 3220   |
  374.             |    4     |   3  | 12840   | 3228   |
  375.             |    5     |   3  | 16928   | 4220   |
  376.             |    6     |   3  | 16936   | 4228   |
  377.             |    7     |   3  | 21024   | 5220   |
  378.             |    8     |   3  | 21032   | 5228   |
  379.             +----------+------+---------+--------+
  380.           A User Defined CommPort must be used for
  381.           PS/2 CommPorts 3-8.
  382.  
  383. 8. OPERATING MODES
  384. --------------------------------------------------------------------
  385. Operating Mode can be set using the 'Options' menu, the MODE command
  386. button (cycles through the modes), or the /M command line argument.
  387. --------------------------------------------------------------------
  388. MODE 1                    Unit
  389.                           Code            NOTE: Mode can be toggled
  390. In this mode only        +-----+                at runtime by clicking
  391. one Unit Code can be     |   1                 the MODE button.
  392. selected from the        |   2 █                (Keyboard users press
  393. Unit Code List Box.      |   3 ░                 ALT-m).
  394.                          |   4 ░
  395.                          |   5 ░                Can also be set from
  396.                          |   6                 the Options Menu.
  397.                          +-----+
  398. RECOMMENDED IF YOU DON'T HAVE A MOUSE.
  399. --------------------------------------------------------------------
  400. MODE 2                             Unit Code(s)
  401.                          +----------------------------+
  402. In this mode multiple    |[X] 1  [ ] 5  [ ] 9   [ ] 13|
  403. Unit Codes can be        |[ ] 2  [ ] 6  [ ] 10  [ ] 14|
  404. checked; in addition     |[ ] 3  [ ] 7  [ ] 11  [ ] 15|
  405. the ALL button can be    |[ ] 4  [ ] 8  [ ] 12  [ ] 16|
  406. clicked to check all     |+-----------+  +-----------+|
  407. the Unit Codes. The      ||    ALL    |  |    NONE   ||
  408. NONE button unchecks     |+-----------+  +-----------+|
  409. all the unit codes.      +----------------------------+
  410.  
  411.  
  412. --------------------------------------------------------------------
  413. MODE 3
  414.                   Unit Location               Description
  415. An X10.DAT      +----------------------------------------------------+
  416. is read and     | A  1|DINING ROOM           |TABLE LAMP             
  417. a List Box      | A  2|FAMILY ROOM           |TV                     █
  418. replaces the    | A  3|GARAGE                |CEILING LIGHT          ░
  419. House/Unit      | A  4|GUEST ROOM            |DE-HUMIDIFIER          ░
  420. Controls used   | G  7|HALL                  |CEILING LIGHT          
  421. in Modes 1 & 2. +----------------------------------------------------+
  422. Also note that   {11 Device(s) Found} Brightness <█░░░░░░░> 1≈00.0%
  423. the Brightness
  424. List Box has been replaced by a Horizontal Slider Control. (above)
  425. --------------------------------------------------------------------
  426. 9. DEBUG MODE
  427.  
  428. +--------------------------------------------------------------------+
  429. | Using COMMPORT: 2  X10DC - X-10 Direct Control  CP290 Day: Tuesday |
  430. |Base House Code: P         Version 1.65         CP290 Time: 11:51 AM|
  431. |Mode: 1   Debug ON    (c)1993-1996 - D.Huras       PC Time: 11:52 AM|
  432. +--------------|-----------------------------------------------------+
  433.                +----|
  434.                   --+-----
  435. When enabled, the DEBUG ON message appears in the screen Header and all
  436. responses from the CP290 are displayed in the Command History List Box,
  437. as well as Checksums and Timing Information.
  438.  
  439. Debug Mode can be toggled ON/OFF from the Options Menu.
  440.  
  441. NOTE: Debug Mode increases program overhead; memory requirements will
  442. be greater and program performance will be somewhat degraded.  It is
  443. recommended that you only toggle Debug Mode ON when necessary.
  444.  
  445. 10. PROGRAM OVERVIEW
  446. --------------------------------------------------------------------
  447. When X10DC initially loads, it requests the base house code and time
  448. stored in the CP290 via serial I/O using the selected COMMPORT.
  449. This information will be reported in the Screen Header if found.
  450. Note:  the CP290 Time and PC Time reported in the Screen are static
  451. and are only updated when the Base House Code is changed, a
  452. Self-Test is run or the Time is set.  You can use the 'Refresh' menu
  453. item under the 'Clock' menu to force an update to the on-screen Time
  454. displays.  The House Code List Box defaults to the Base House Code
  455. if the CP290 is found.  Once the program is loaded the SEND command
  456. button is disabled until you have selected all required
  457. information.  In some cases you need only to select a House Code and
  458. an Action (eg. All Units Off).  If the selected action is DIM, then
  459. a Brightness Level must be be selected before the SEND button
  460. becomes enabled.
  461.  
  462. The program supports 3 operating modes; use whatever mode suits
  463. your requirements.  Mode 3, which reads in Device Descriptions
  464. from an X10.DAT file, is likely the most user-friendly since you
  465. do not have to remember specific House/Unit code addresses.  X10EC
  466. a companion program to X10DC can read, write, and create X10.DAT
  467. files.
  468.  
  469. The Command History list box is scrollable and will store up to 1000
  470. commands after which it becomes a circular FIFO buffer.  If you
  471. suspect problems with your CP290, then you may want to toggle
  472. Debug Mode ON; in this case the Command History list box will
  473. contain additional information including responses from the CP290.
  474. You may also want to perform a CP290 Self-Test to ensure that
  475. the CP290 Memory is not being corrupted.
  476.  
  477. Finally, if you are experiencing X-10 transmission problems in your
  478. application; you may want to take advantage of the Signal Test
  479. Generator or Transmission Logging features provided by X10DC.  These
  480. subjects are covered in detail in a later section of this document.
  481.  
  482. 11. KEYBOARD USAGE
  483. --------------------------------------------------------------------
  484. Use the TAB/Shift-TAB keys to move among the various controls.(*3)
  485. The Up/Down arrows can be used to move up and down List Boxes, and
  486. the Spacebar and Enter key can be used to select the current List
  487. Box item, check/uncheck a check box, or invoke a command button.
  488. The ESCAPE key will exit the current function or the program if no
  489. other windows are visible.  All of the Command Buttons and controls
  490. have quick access keys:
  491.  
  492.      House Code - Alt-o [Mode 1 & 2]
  493.    Unit Code(s) - Alt-u [Mode 1 & 2]
  494.     Device List - Alt-u [Mode 3]
  495.             ALL - Alt-l [Mode 2]
  496.            NONE - Alt-n [Mode 2]
  497.          Action - Alt-a
  498.      Brightness - Alt-b [when enabled]
  499.  
  500.            MODE - Alt-m (*3)
  501.            SEND - Alt-s
  502.            EXIT - Alt-x
  503.            HELP - Alt-h
  504.  
  505. Command History - Alt-c
  506.  
  507. (*3) The MODE Command Button is NOT in the TAB STOP sequence;
  508.      Keyboard users must use ALT+character to access this
  509.      button. (This eliminates extraneous TAB keystrokes)
  510.  
  511. 12. MENU BAR
  512. --------------------------------------------------------------------
  513. Press & release the ALT key to activate the Menu Bar.  Menu items
  514. can be selected by pressing the highlighted key (when applicable),
  515. or by positioning the highlight bar using the up/down arrow keys and
  516. pressing ENTER.  Some screen button functions are replicated within
  517. the menus (eg. Exit, Help).  However, there are some functions which
  518. are only available from within menus.  CommPort, Operating Mode,
  519. Debug, Sounds & Preserve Icon Data can all be set from the Options
  520. Menu; the current state of each of these parameters is indicated on
  521. the menu itself with a '-' character to the left of the menu item.
  522.  
  523. The following short-cut keys can also be used at any time to
  524. select menu items:
  525.  
  526. *FILE* Menu
  527.           Load X10 File - Ctrl-L
  528.               Exit      - Ctrl-X (Same as Exit Button, Alt-X)
  529.  
  530. *CLOCK* Menu
  531.            Set PC Clock - Ctrl-T (Enter Time)
  532.         Set CP290 Clock - Ctrl-K (Synchronize w/PC) - Registered Version
  533.          Refresh Clocks - Ctrl-R
  534.      Set Base HouseCode - Ctrl-B (Preserve Events) - Registered Version
  535.  
  536. *TEST* Menu
  537.         CP290 Self Test - Ctrl-E
  538.   Signal Test Generator - Ctrl-N
  539. Log CP290 Transmissions - Ctrl-S
  540.  
  541. *OPTIONS* Menu
  542.                  Mode 1 - Shift-F1
  543.                  Mode 2 - Shift-F2
  544.                  Mode 3 - Shift-F3
  545.  
  546.           Sounds Toggle - Ctrl-U
  547.       Debug Mode Toggle - Ctrl-D
  548.      Preserve ICON Data - Ctrl-I
  549.  
  550.          Communications - Ctrl-C
  551.  
  552.          Screen Colours - Ctrl-G
  553.  
  554.            Save Options - Ctrl-O
  555.  
  556. *HELP* Menu
  557.                    Help - F1 (Same as Help Button, Alt-H)
  558.                   About - Ctrl-A
  559.  
  560. 13. UNDOCUMENTED CP290 COMMANDS
  561. --------------------------------------------------------------------
  562. X10DC supports the following undocumented CP290 commands:
  563.  
  564.    Fade OFF   - DIMS Light(s) to 0 then turns Unit(s) OFF
  565.                 (Can target multiple units for this command)
  566.    X-Light ON - Exclusive Light ON - Issues an ALL LIGHTS OFF
  567.                 then Brightens selected Unit(s)
  568.                 (Can target multiple units for this command)
  569.    All Lights ON  - All Lights on selected House Code set ON
  570.    All Lights OFF - All Lights on selected House Code set OFF
  571.    All Units OFF  - All Units on selected House Code set OFF
  572.  
  573. NOTE:  X-10 Light Switches usually respond to the ALL LIGHTS ON
  574.        command; however some Lamp Modules appear to ignore it;
  575.        increasing the DIM level when using this command occasionally
  576.        resolves this apparent hardware problem.
  577.  
  578. 14. INCREMENTAL BRIGHTENING
  579. --------------------------------------------------------------------
  580. X-10 Light Switches and Lamp Modules can be incrementally brightened by
  581. sending X-10 BRIGHT commands to them.  However, the CP290 controller has
  582. a built-in macro that forces these modules to 100% brightness and then
  583. sends X-10 DIM commands to them to dim them down to the desired
  584. brightness level.  This prevents you from gradually brightening a module
  585. over a period of time by sending several DIM commands with increasing
  586. brightness levels (the end result will be the desired brightness level,
  587. but after each command the module will be ramped up to 100% only to be
  588. dimmed back down to the desired brightness level).
  589.  
  590. The undocumented X-LIGHT command can be used to gradually brighten an
  591. X-10 Lamp Module but not an X-10  Wall Switch due to an inherent anomaly
  592. with the X-10 Lamp Modules.  The CP290 acts on an X-LIGHT command by
  593. sending several ALL LIGHTS OFF commands followed by a number of BRIGHT
  594. commands corresponding to the DIM level set.  If an X-10 Lamp Module or
  595. Wall Switch is currently off and a BRIGHT or DIM command is sent, that
  596. module will turn ON at 100% and then dim/brighten accordingly. However,
  597. most X-10 Lamp Modules do not respond to the ALL LIGHTS OFF command.
  598. So, when an X-LIGHT command is sent to the CP290 and it generates an ALL
  599. LIGHTS OFF command it will have no impact on the Lamp Module, however,
  600. the Lamp Module will respond to the subsequent BRIGHT commands by
  601. brightening from the current brightness level (without going to 100%
  602. brightness) providing it was NOT OFF  to begin with.  This means you can
  603. incrementally brighten one or more Lamp Modules by following these
  604. steps:
  605.  
  606. (1) Dedicate a House Code for those Lamp Modules that you wish to
  607.     incrementally brighten.  (Otherwise, any Wall Switch Modules on the
  608.     same house code will end up at 100% brightness).
  609.  
  610. (2) Send a DIM Command (0% Brightness) to the targetted Lamp Modules.
  611.  
  612. (3) Send a variable number of X-LIGHT Commands to the targetted Lamp
  613.     Modules.
  614.  
  615. NOTE: The Brightness Levels associated with X-LIGHT commands are
  616. CUMULATIVE. For example, if you send an X-LIGHT Command with a
  617. brightness level of 20%, the targetted Lamp Module will
  618. incrementally brighten to 20% (assuming it was on at a brightness
  619. level of 0% to begin with). If you send the same command a second
  620. time, the Lamp Module will brighten to 40%.
  621.  
  622. 15. CP290 SELF TEST
  623. --------------------------------------------------------------------
  624. The CP290 can perform a Self-Test to determine if there are any
  625. detectable problems within the device.  The Self-Test will return
  626. either a pass or fail status when it is run.  X10DC will report the
  627. results of the test in the CP290 Status window.  Whenever a
  628. Self-Test is run the memory contents of the CP290 are overwritten.
  629. X10DC can preserve the CP290 Event and Icon Data by downloading it
  630. from the CP290 prior to the Self-Test and uploading it back to the
  631. CP290 after the Test.  (X10DC also allows a Self-Test to be invoked
  632. without event preservation, but this leaves the device in a state
  633. which may cause problems with other programs that communicate with
  634. the CP290. It is recommended that the Self-Test always be invoked
  635. with Event Preservation regardless of whether or not there is any
  636. stored Event Data.)
  637.  
  638. 16. SIGNAL TEST GENERATOR
  639. --------------------------------------------------------------------
  640. The Signal Test Generator is a powerful feature that enables the
  641. user to track down and isolate X-10 transmission/reception problems
  642. and faulty modules.  This feature will send X-10 ON/OFF commands
  643. repeatedly until the test is ended by the user.  (Similar to the
  644. Leviton 6385 device).  The address to be targetted for commands can
  645. be a fixed House Code and Unit Code; alternatively, either the House
  646. Code or Unit Code (or both) can be varied. This allows you to send
  647. commands repeatedly to:
  648.  
  649. - A 'Fixed' House Code & 'Fixed' Unit Code (eg. A1)
  650. - A 'Fixed' House Code & 'Variable' Unit Code (eg. A1 - A16)
  651. - A 'Variable' House Code & 'Variable' Unit Code (ie. A1 - P16;
  652.   All 256 addresses would be tested in this case)
  653. - A 'Variable' House Code & 'Fixed' Unit Code (eg. A1 - P1)
  654.  
  655. When the Signal Test Generator is selected, a window is
  656. displayed that allows you to set the House Code & Unit Code to
  657. either 'Fixed' or 'Variable' mode; if 'Fixed' is selected then
  658. a List Box is enabled so that the fixed code can be selected.
  659. The Delay between commands can be set from 0 to 60 seconds;
  660. this delay applies to the pause between each pair of ON/OFF
  661. commands.  Once all required settings have been made the OK
  662. button becomes enabled.  When the OK button is clicked the
  663. test will begin; the test can be terminated by pressing [Esc].
  664. Note, if the Delay is set to 0, then the [Esc] key may have to
  665. be hit several times to stop the Signal Test.  X10DC will emit
  666. a brief beep before each ON command is sent, and another lower
  667. pitched beep before each OFF command is sent.  These beeps can
  668. be disabled by toggling the Sounds item on the 'Options'
  669. Menu.
  670.  
  671. 'Fixed' Mode Testing
  672. --------------------
  673. Generally speaking, you would want to use the 'Fixed' option
  674. to test the range of X-10 signal reception by starting the
  675. Signal Test using address P1 for example (the "only" address
  676. that the Leviton 6385 will test) and then walking around to a
  677. variety of outlet locations within your home and plugging in a
  678. module set to P1 to see if the ON & OFF commands are being
  679. received at all locations.  The program attempts to let you
  680. know when the commands are sent by beeping although you may
  681. not be able to hear the beep from all outlet locations.
  682.  
  683. 'Variable' Mode Testing
  684. -----------------------
  685. The 'Variable'(*4) option can be used when you suspect that an
  686. X-10 module has trouble receiving commands targetted for
  687. specific House and/or Unit Codes.  In this case, instead of
  688. walking around to locations, you would adjust the House and/or
  689. Unit Code dials on the module as the Signal Test cycles
  690. through each combination.  You may want to toggle the Sounds
  691. off in this case.
  692.  
  693. ----
  694. (*4) Not available in UNREGISTERED Version
  695.  
  696. 17. CP290 TRANSMISSION LOGGING
  697. --------------------------------------------------------------------
  698. This diagnostic feature captures and displays the CP290 'command
  699. echoes' in a scrollable list box that can be printed at any time.
  700. Whenever the CP290 imposes an X-10 command onto the powerline it
  701. also transmits a 'command echo' via the serial interface.  The
  702. 'command echo' is transmitted for both scheduled events and for
  703. X-10 commands initiated using the rocker keys on top of the CP290.
  704. This feature allows you to confirm that the CP290 is actually
  705. transmitting X-10 commands as per the event schedule stored in
  706. its memory.  The command echoes are captured by X10DC and a checksum
  707. is verified before an entry is added to the Transmission Log. Any
  708. errors detected during the serial transmission of the command echo
  709. are also added to the Transmission Log.  The Transmission Log can
  710. be printed at any time by using the 'Print Log' command button.
  711. During the printing process transmission logging is temporarily
  712. suspended.  There are some limitations associated with the command
  713. echoes transmitted by the CP290, specifically:
  714.   - the DIM level associated with DIM commands is not transmitted.
  715.   - there is no distinction made between OFF (documented) and
  716.     FADE-OFF (undocumented) command transmissions.
  717. The capacity of the CP290 Transmission Log is 1000 entries, once
  718. this maximum has been reached the oldest log entry will be deleted
  719. each time a new log entry is added.
  720.  
  721. 18. CLOCK SYNCHRONIZATION
  722. --------------------------------------------------------------------
  723. Clocks tend to run either fast or slow and therefore should be
  724. synchronized periodically.  X10DC allows you to set the time in both
  725. the PC and CP290 manually by specifying hh:mm and also allows you to
  726. synchronize the PC and CP290 by using one of the clocks to set the
  727. other.  When the PC clock is used to synchronize the CP290 clock,
  728. X10DC will wait until the seconds are at zero since the resolution
  729. of the CP290 clock is limited to minutes.  (This wait can be
  730. cancelled by pressing the [Esc] key).  When the CP290 is used to
  731. synchronize the PC, the hours and minutes from the CP290 are used
  732. immediately to set the PC Clock; since the CP290 cannot provide
  733. 'seconds', it is recommended that a CP290->PC Clock Sync be followed
  734. by a PC->CP290 Clock Sync.  This will ensure that both Clocks are
  735. synchronized.
  736.  
  737. 19. BASE HOUSECODE
  738. --------------------------------------------------------------------
  739. The Base HouseCode stored in the CP290 is only applicable to the
  740. rocker keys on the top of the CP290.  These keys are labelled 1 to 8
  741. and correspond to whatever House Code is stored as the Base
  742. HouseCode in the CP290.  The CP290 re-initializes itself whenever
  743. the Base HouseCode is changed; as a result, all of the CP290 Event
  744. Data is erased.  X10DC gives you the option of either Preserving or
  745. Erasing the Event and Icon Data whenever the Base HouseCode is
  746. changed.  If the user elects to preserve the Event Data, it is
  747. downloaded from the CP290 before the Base HouseCode is changed and
  748. then uploaded back to the CP290 after the Base HouseCode has been
  749. changed.
  750.  
  751. 20. PROBLEM RESOLUTION
  752. --------------------------------------------------------------------
  753. Generally, if your CP290 works with the X-10 supplied software then
  754. you should have no problems running X10DC.  X10DC has been
  755. successfully tested under Microsoft Windows v3.1 and OS/2 v2.1.  The
  756. program will load if you run it without any arguments (thereby
  757. defaulting to COMMPORT 1) and your CP290 is actually attached to
  758. COMMPORT 2.  If this is the case X10DC will report 'Timed Out
  759. waiting for a response' when it attempts to retrieve the CP290 Time,
  760. Day of Week and Base HouseCode.  You can toggle to the correct
  761. COMMPORT once the program is running by using the Options,
  762. Communications menu.  The Save Options menu option will save all
  763. settings to the X10DC.INI which obviates the need for command line
  764. arguments.
  765.  
  766. If you run X10DC with a modem attached to the COMMPORT, you may get
  767. unpredictable results since the modem will echo everything back to
  768. X10DC.
  769.  
  770. If you run X10DC with a modem attached to the COMMPORT, you may get
  771. unpredictable results since the modem will echo everything back to
  772. X10DC.  If you're using a COMMPORT that shares an interrupt with
  773. another COMMPORT (eg. 1 & 3, 2 & 4), then you must ensure that no
  774. memory resident software (eg. a FAX TSR) that uses the other COMMPORT
  775. is loaded as it will not release the interrupt.
  776.  
  777. If you use a Serial Mouse, this may cause a conflict if X10DC
  778. attempts to communicate with a CP290 on the same CommPort.  You may
  779. want to start X10DC with the /C command line argument to ensure it
  780. does not default to CommPort 1 if your mouse is also on CommPort 1.
  781. X10DC will not run properly if it attempts to communicate with a
  782. COMMPORT that has been initialized with a Mouse Driver (ie. you
  783. cannot use a switchbox between the CP290 and a Mouse unless you
  784. reboot without loading the Mouse Driver).
  785.  
  786. The X10DC executable file is encrypted and there is a remote
  787. possibility that the decryption process may fail with certain
  788. processors; a blank screen immediately after attempting to run the
  789. program typifies this problem.  Please contact the author if you
  790. encounter this problem.
  791.  
  792. In some cases X10DC may report communication errors (ie.  time-outs,
  793. unmatched checksums, etc).  This may occur when scheduled Events
  794. collide with CP290 Uploads/Downloads that are in progress.  (The
  795. CP290 transmits onto the serial port line whenever a scheduled event
  796. occurs and when you press the rocker buttons on the CP290).  X10DC
  797. attempts to minimize collisions by discarding unexpected serial
  798. input, however the possibility still exists.  You should just
  799. re-invoke the interrupted action to recover from this type of
  800. problem.
  801.  
  802. If you are sure that the X10DC is using the correct COMMPORT and
  803. problems persist, try using Debug mode and then scroll through the
  804. Command History List Box; see if the calculated checksums match;
  805. look at the Elapsed and Wait Time Values. If the Elapsed Time
  806. exceeds the Wait Time value then the program is timing out while
  807. waiting for X-10 responses. PLEASE REPORT ANY TIMING PROBLEMS TO ME;
  808. adjustments can be made to the program to improve its compatibility
  809. if this turns out to be a problem.  As a last resort, run the CP290
  810. Self Test, but only do so if you have backed up your EVENT DATA
  811. using a program you are sure works within your operating
  812. environment.  (X10DC will preserve the CP290 Event Data but if you
  813. are experiencing problems with X10DC then this function may fail).
  814.  
  815. The open architecture of the PC compatible operating environment and
  816. the near infinite combinations of hardware and software complicate
  817. the compatibility of applications software.  While every effort has
  818. been made to ensure that X10DC is compatible with all
  819. hardware/software combinations, there may be operating environments
  820. in which X10DC will not run properly.
  821.  
  822. Problems can be reported to:
  823.  
  824.    David Huras
  825.    37 Ruddell Crescent
  826.    Georgetown, Ont. L7G 5N4
  827.    CANADA
  828.  
  829.    FAX: 905-873-6429
  830.    CIS: 72767,472
  831.    Internet: davidhuras@inforamp.net
  832.  
  833. 20. REGISTRATION INFORMATION
  834. --------------------------------------------------------------------
  835. The registration fee for X10DC is $20. (US Dollars for US shipping
  836. addresses, CDN Dollars for Canadian shipping addresses).  X10DC is
  837. currently supplied as functioning software without built-in delays
  838. or obtrusive "nag" screens prompting you to register.  The Signal
  839. Test Generator & Mode 3 are the only features not fully supported in
  840. the shareware version of X10DC.  A SIGNIFICANT amount of time and
  841. effort went into this program; please register the program if you
  842. intend to use it beyond the 30-day evaluation period.  Registered
  843. Users will be shipped a printed manual and a 3.5" diskette (if you
  844. would prefer a 5.25" diskette please advise) containing the
  845. registered version of the program.  Registration Benefits:
  846.  
  847. - Full support for the Signal Test Generator which allows you to
  848.   cycle through all House & Unit Codes and send an ON/OFF command
  849.   to each address.
  850.  
  851. - Full support for operating mode 3 which reads in an X10.DAT file
  852.   and builds a "list box" of device names which can be targetted
  853.   for X10 commands.  (Unregistered Version will only send commands
  854.   to the first 8 Devices).
  855.  
  856. - BONUS PROGRAMS: Registered Users will also receive 2 bonus
  857.   programs:
  858.  
  859.   1)  X10DAT reads an X10.DAT file and prepares a report
  860.       listing all installed devices and scheduled events including
  861.       "frozen" events and multiple unit events. See the X10DAT.RPT
  862.       file for a report sample.
  863.  
  864.   2)  XDC issues immediate X-10 command directives to the CP290
  865.       directly from the DOS prompt.  Alternatively, you can pass
  866.       a filename to XDC containing 'batched' X-10 command directives.
  867.       XDC supports the 5 undocumented CP290 commands that are
  868.       supported by X10EC & X10DC. See the XDC.DOC file for additonal
  869.       information.
  870.  
  871. - DISCOUNTED REGISTRATION FEE for X10EC; X-10 Event Control.
  872.   Registered Users can register X10EC for $20; the regular
  873.   registration fee is $25.
  874.  
  875. To expedite your registration, you may wish to register using
  876. CompuServe Shareware Registration; you will receive a Registration
  877. Key via CompuServe E-Mail within 1 business day that will enable the
  878. registered program features. (See CompuServe Shareware Registration
  879. below).  Alternatively, you can charge the Registration Fee to your
  880. VISA, Master Card, or American Express.  (See PsL Shareware
  881. Registration Program below).  If you elect to use either of methods
  882. your software will ship within 1 business day.
  883.  
  884. If you do not wish to register via CompuServe Shareware Registration
  885. or the PsL Shareware Registration Program then complete the order
  886. form in the REGISTER.FRM file and send with your payment to:
  887.  
  888.    David Huras
  889.    37 Ruddell Crescent
  890.    Georgetown, Ont. L7G 5N4
  891.    CANADA
  892.  
  893. CompuServe Shareware Registration
  894. =================================
  895. You can register X10DC, X10EC or BOTH using CompuServe Shareware
  896. Registration.  The Registration Fee will be charged to your
  897. CompuServe billing account and the latest version of the software
  898. along with a printed User Guide will be shipped within one business
  899. day.  In addition, you will receive a Registration Key via
  900. CompuServe E-Mail (within one business day) that will immediately
  901. allow you to run X10DC with the registered version features enabled
  902. while you wait for your diskette to arrive.  GO SWREG while on
  903. CompuServe to use Shareware Registration.
  904.  
  905. Program Title         Program Name    Program ID#   Charge
  906. ===================   ============    ===========   =======
  907. X-10 Direct Control      X10DC             620       $20.00
  908. X-10 Event Control       X10EC            1774       $25.00
  909.  
  910. X-10 Control Bundle      X10CB            1775       $40.00
  911. (X10DC + X10EC)
  912.  
  913. X10WC CompuServe Registration
  914. =============================
  915. You can also register X10WC (X-10 Windows Control) using CompuServe
  916. Shareware Registration.  The Registration Fee will be charged to your
  917. CompuServe billing account and a Registration Key File will be forwarded
  918. to you via Compuserve E-Mail within 1 business day.  This Registration
  919. Key File will immediately allow you to run the current and future
  920. versions of X10WC with all of the registered features enabled.  A
  921. diskette will NOT be shipped to you if you elect to register using
  922. Compuserve Shareware Registration, however, once you are a registered
  923. user you can order a diskette upgrade at any time for $2.00; see
  924. DISKETTE.FRM.  GO SWREG to access CompuServe Shareware Registration.
  925.  
  926. Program Title          Program Name    Program ID#   Charge
  927. ===================   ============    ===========   =======
  928. X-10 Windows Control      X10WC           5226       $32.00
  929.  
  930. PsL Shareware Registration Program
  931. ==================================
  932. Charge the Registration Fee to your Visa, Master Card, or American
  933. Express by ordering X10DC or X10EC (specify Program # below) from
  934. Public (software) Library, call 800-242-4PsL (713-524-6394 overseas)
  935. or FAX your order to 713-524-6398.  PsL will forward your order to me
  936. via Compuserve E-Mail and your order will be shipped within one
  937. business day.  Note, these phone numbers are for ordering only.  ALL
  938. OTHER INQUIRIES (eg. technical support, volume discounts site
  939. licensing) should be directed to the author: see program
  940. documentation.
  941.  
  942. Program Title         Name  Program #  Charge   Handling  Total
  943. ===================  ====== =========  ======   ======== ======
  944. X-10 Direct Control  X10DC   10924     $20.00    $0.00   $20.00
  945. X-10 Event Control   X10EC   11595     $25.00    $1.00   $26.00
  946. X-10 Windows Control X10WC   14258     $32.00    $1.00   $33.00
  947.  
  948. You can also register via PsL on the Internet by accessing URL:
  949.     WWW: http://206.109.101.6/cgi-win/psl_ord.exe/item10924
  950.  
  951.  
  952. 21. UPGRADE INFORMATION
  953. --------------------------------------------------------------------
  954.  
  955. Quick Upgrade
  956. =============
  957. REGISTERED USERS of prior versions of X10DC can immediately run the
  958. shareware version of X10DC v1.60 and all future shareware versions
  959. of X10DC with the registered features enabled.  X10DC will look in
  960. the current sub-directory for the X10DC.KEY file; if a valid file is
  961. found then X10DC will enable all registered program features.  This
  962. means you can upgrade by downloading the latest shareware version of
  963. X10DC and ensuring that your X10DC.KEY file resides in the same
  964. sub-directory.
  965.  
  966. Existing Registered Users
  967. =========================
  968. If you registered a version of X10DC prior to 1.10; then you are
  969. entitled to an X10DC.KEY file that will enable you to immediately
  970. use the shareware version of X10DC v1.60 with the registered
  971. features enabled.  Your X10DC.KEY file can be forwarded via
  972. CompuServe E-Mail, Internet E-Mail, or you can download it directly
  973. from the author.  Please contact the author via E-Mail or FAX to
  974. arrange for the delivery of your X10DC.KEY file.
  975.  
  976. Diskette Upgrade
  977. ================
  978. REGISTERED USERS of prior versions of X10DC can request a diskette
  979. containing the current version of the software at ANY TIME by simply
  980. sending a diskette containing their registered version of the
  981. software and $2 for postage to the author.
  982.  
  983. 22. RELEASE HISTORY - X10DC Shareware/Registered Version
  984. --------------------------------------------------------------------
  985.  Date      Version     Changes
  986. ------   ----------   ----------------------------------------------
  987. JUN'96    1.65        - Updated X-LIGHT Command Processing so that
  988.                         Brightness Level inversion is not required;
  989.                         Incremental Brightening section added to
  990.                         documentation and HELP file.
  991.                       - Updated Author E-Mail Address
  992.  
  993. OCT'94    1.60        -Added CP290 Transmission Logging Feature
  994.                        (with Print capability)
  995.                       -QUICK Registration/Upgrade Feature Added
  996.                       -Save Options now enabled in Shareware Version
  997.                       -INI File processing now enabled in Shareware
  998.                        Version
  999.                       -INI parsing enhanced; invalid directives are
  1000.                        now ignored with a message regardless of
  1001.                        DEBUG status
  1002.                       -Command Argument parsing enhanced; invalid
  1003.                        arguments are now ignored with a message
  1004.                       -X10DC will now prompt you to Save Options if
  1005.                        program exit is requested and options have
  1006.                        been modified but not saved
  1007.                       -Communications Setup enhanced; a dedicated
  1008.                        screen is now used that allows dynamic setup
  1009.                        of User Defined CommPort
  1010.                       -All SPIN Controls changed to Vertical Scroll
  1011.                        Bars for performance (and compatibility with
  1012.                        X10EC)
  1013.                       -Common Dialog Forms loaded at Program Startup
  1014.                       -/F: Command Line Argument forces Mode 3 on Startup
  1015. DEC'93    1.50        -Added support for 5 UNDOCUMENTED CP290 Cmds
  1016.                       -Added support for ICON Data Preservation
  1017.                       -Optimized screen layout for all 3 Modes
  1018.                       -Added support for EGA/VGA 43/50 Line Mode
  1019.                       -Added graphic 'percentage complete' gauges
  1020.                       -Countdown Timer added to Status Window while
  1021.                        waiting for CP290 responses.
  1022. NOV'93    1.42        -Corrected problem reporting Base House Code
  1023.                        when CP290 returns bad data.
  1024. AUG'93    1.41        -Public (software) Library registration method
  1025.                        added to documentation.
  1026.                       -X10DAT Bonus Program added as registration
  1027.                        benefit.
  1028.                       -X10DC.INI File Comment re: X10File argument
  1029.                        corrected in documentation.
  1030. AUG'93    1.40        -Corrected 'Load X10 File' problem when X10.DAT
  1031.                        located in Root Directory.
  1032.                       -Corrected problem whereby X10DC.INI was not
  1033.                        processed when X10DC was started from a Root
  1034.                        Directory (impacted Registered Version only).
  1035. AUG'93    1.40 ß      -COMMPORT 3 & 4 Support Added.
  1036.                       -User Defined CommPort support Added.
  1037.                       -Minor changes to default colours (LABELS).
  1038. JUL'93    1.32        -Corrected problem with DEBUG MODE colour setting
  1039.                        not 'sticking'; setting from INI is workaround.
  1040.                        (Not released).
  1041. JUL'93    1.31        -Fixed mouse cursor reset problem if Signal Test
  1042.                        is run without a CP290 device. (Not released).
  1043. JUL'93    1.30        -ENABLED SEND Command under MODE 3 in Unregistered
  1044.                        version for 1st 8 Devices in X10.DAT File
  1045.                       -ENABLED ALL Clock Sychronization options in
  1046.                        Unregistered version
  1047.                       -ENABLED Change Base HouseCode with Event
  1048.                        Preservation in Unregistered version
  1049.                       -ENABLED Screen Colours dialogue in Unregistered
  1050.                        version
  1051.                       -Test menu item added to Menu Bar;
  1052.                        - CP290 Self Test disassociated with Debug Mode
  1053.                          and Self Test button removed from Screen
  1054.                          Header; Self-Test feature now a sub-menu
  1055.                          item under Test.
  1056.                        - Signal Test Generator feature added; send
  1057.                          ON/OFF commands repeatedly to a fixed/variable
  1058.                          House Code/Unit Code address.  Unregistered
  1059.                          version supports the fixed option only.
  1060.                       -Help Sub-system added; contains additional
  1061.                        X10 background information as well as extracts
  1062.                        from the documentation file.
  1063.                       -/NH command line argument added to optionally
  1064.                        not load the help system for faster program
  1065.                        load times.
  1066.                       -/NS command line argument added to disable
  1067.                        sounds generated during the Signal Test.
  1068.                       -Sounds Toggle added as a sub-menu item under
  1069.                        Options.
  1070.                       -INI Overwrite warning now uses the WARNING
  1071.                        screen title colour(*5)
  1072.                       -'Save Options' displays a message box whenever
  1073.                        INI options are saved(*5)
  1074.                       -The access key for the 'Exit' option under the
  1075.                        'File' menu changed from 'E' to 'x'.
  1076.                       -[Esc] key will now back out any screen
  1077.                        colour changes while in the Screen Colours
  1078.                        dialogue
  1079.                       -[Esc] key will now skip the wait while
  1080.                        SYNC'ing the CP290 clock based on the PC
  1081.                        Clock
  1082. MAR'93    1.20        -Merged Shareware & Registered Versions;
  1083.                        Registered Version features are disabled in
  1084.                        the Unregistered version, specifically:
  1085.                          - Complete Mode 3 Support (X10.DAT File)
  1086.                          - Complete Screen Color Customization
  1087.                            Dialogue
  1088.                          - INI File Support to save/modify
  1089.                            Program settings/colors
  1090.                          - Preserve/Restore Event Data when
  1091.                            Base House Code changed
  1092.                          - PC » CP290 Clock Synchronization
  1093.                          - CP290 » PC Clock Synchronization
  1094.                       -ENABLED Self Test EVENT Preservation
  1095.                        in Unregistered version
  1096.                       -ENABLED MODE 3 Switch & X10.DAT File Load
  1097.                        in Unregistered version (SEND-Disabled)
  1098.                       -ENABLED some Clock Functions, & Base House
  1099.                        Code Setting in Unregistered Version
  1100.                       -CP290 Self Test changed to reset interface
  1101.                        upon completion (The self test overwrites
  1102.                        the Event Data and this data may cause
  1103.                        problems with some programs)
  1104.                       -Added /BW command line argument to startup
  1105.                        with monochrome color settings
  1106.                       -Added 'Refresh' menu item to refresh on-screen
  1107.                        Clock Displays
  1108.                       -Error handling improved
  1109.                       -Retry logic added for all CP290 communications
  1110.                        with automatic wait time adjustment (if program
  1111.                        times out waiting for a response, it will
  1112.                        increase the wait time if the command is retryed)
  1113.                       -Command History caption now indicates which
  1114.                        entry is highlighted (ie. entry x of n)
  1115.  
  1116. MAR'93    1.10        -MENU BAR Added - CommPort,Mode, & Debug can
  1117.                        now be changed using the Options Menu
  1118.                       -Mode Indicator added to Screen Header
  1119.                       -Minor Screen Colour modifications
  1120.  
  1121. FEB'93    1.00        -Mode Switch Command Button Added (Alt-M)
  1122.                       -Debug Command Button TAB Stop disabled-keyboard
  1123.                        users must use ALT-T
  1124.                       -CIS Software Registration # added to ABOUT
  1125.  
  1126. FEB'93    1.00 ß.02   -Operating Mode 2 Added (FIRST PUBLIC RELEASE)
  1127.                       -Operating Mode 3 Added to Registered Version
  1128.                       -Clock/Base House Code manipulation added to
  1129.                        Registered Version
  1130.  
  1131. JAN'93    1.00 ß.01   -Debug Mode Added
  1132.  
  1133. JAN'93    1.00 ß.00   -Initial Beta (not publicly released)
  1134.  
  1135. ------
  1136.  (*5) Applicable to REGISTERED VERSION Only.
  1137.